home *** CD-ROM | disk | FTP | other *** search
/ Experimental BBS Explossion 3 / Experimental BBS Explossion III.iso / disk / acdc120.zip / ACDC.DOC < prev    next >
Text File  |  1994-01-08  |  42KB  |  984 lines

  1.  
  2.  
  3.  
  4.                   Audio Compact Disc Controller version 1.20
  5.  
  6.  
  7.                       A resident audio CD player for dos
  8.  
  9.  
  10.                   Copyright (c) 1993-94, Anders Roar Nielsen
  11.  
  12.  
  13.                            ---=== Shareware ===---
  14.  
  15.  
  16.         *   Do you from time to time play audio CD's with your CD-ROM?   *
  17.         *                                                                *
  18.         *   Yes?  But your CD can only play from the start to the end?   *
  19.         *                                                                *
  20.         *     Yes?  And you would really like to be in full control?     *
  21.         *                                                                *
  22.         *   Yes?  Like repeat or random play, or selected tracks only?   *
  23.         *                                                                *
  24.         *  Yes?  And of course all of it while running another program?  *
  25.         *                                                                *
  26.         * Yes? Then the Audio Compact Disc Controller is a must for you! *
  27.         *                                                                *
  28.         *                                                                *
  29.         *   ╔═════════════════════════ ACDC ═════════════════════════╗   *
  30.         *   ║                                                        ║   *
  31.         *   ║  Featuring full background control, you can play your  ║   *
  32.         *   ║  favorite tracks while using almost any other program  ║   *
  33.         *   ║                                                        ║   *
  34.         *   ╚════════════════════════════════════════════════════════╝   *
  35.         *                                                                *
  36.         *                                                                *
  37.         *                       Features include:                        *
  38.         *                                                                *
  39.         *      Start, stop, pause, resume, skip, accelerating scan.      *
  40.         * Random play, repeat one or all tracks, A-B repeat, intro scan. *
  41.         *   Informative status display and six different time displays.  *
  42.         *       Intelligent location scrollbar and program listing.      *
  43.         *            Stereo volume control with instant mute.            *
  44.         *                Open/close and lock/unlock door.                *
  45.         *                Supports multiple CD-ROM drives.                *
  46.         *       Everything easily controlled by keyboard or mouse.       *
  47.         *    Option for time display on top of textmode applications.    *
  48.         *                                                                *
  49.         *  Pop-up utility, icon and pif for Microsoft Windows included.  *
  50.         *                                                                *
  51.         *             Registered version fully programmable.             *
  52.         Audio Compact Disc Controller v1.20                           Page 1
  53.  
  54.  
  55.  
  56.  
  57.                                    CONTENTS
  58.  
  59.  
  60.  
  61.  
  62.                 Contents.......................................1
  63.  
  64.                 Disclaimer.....................................2
  65.  
  66.                 Agreement......................................2
  67.  
  68.                 Shareware......................................3
  69.  
  70.                 Introduction...................................3
  71.  
  72.                 Warning........................................4
  73.  
  74.                 Hard- and software requirements................4
  75.  
  76.                 Files..........................................5
  77.  
  78.                 Installation...................................5
  79.  
  80.                 Start up.......................................5
  81.  
  82.                 Using the program..............................6
  83.  
  84.                 Functions......................................6
  85.  
  86.                 Using the program with Microsoft Windows......11
  87.  
  88.                 Command line options..........................12
  89.  
  90.                 Troubleshooting...............................13
  91.  
  92.                 Registration..................................14
  93.  
  94.                 Upgrading.....................................16
  95.  
  96.                 Getting the latest version of the program.....17
  97.  
  98.                 Contacting the author.........................17
  99.  
  100.                 Credits.......................................17
  101.  
  102.                 Future plans..................................18
  103.  
  104.                 Revision history..............................18
  105.         Audio Compact Disc Controller v1.20                           Page 2
  106.  
  107.  
  108.  
  109.  
  110.                                   DISCLAIMER
  111.  
  112.  
  113.         Anders Roar Nielsen is the author of Audio Compact Disc Controller.
  114.  
  115.         Users of Audio Compact Disc Controller must accept this disclaimer
  116.         of warranty:
  117.  
  118.         "Audio Compact Disc Controller is supplied as is. The author dis-
  119.         claims all warranties, expressed or implied, including, without li-
  120.         mitation, the warranties of merchantability and of fitness for any
  121.         purpose. The author assumes no liability for damages, direct or
  122.         consequential, which may result from the use of or inability to use
  123.         Audio Compact Disc Controller, even if the author has been advised
  124.         of the possibility of such damages."
  125.  
  126.  
  127.  
  128.  
  129.                                    AGREEMENT
  130.  
  131.  
  132.         Audio Compact Disc Controller is a shareware program and is provided
  133.         at no charge to the user for evaluation. The program is a stand-
  134.         alone program without any connection to specific CD-ROM drives or
  135.         any other hard- or software.
  136.  
  137.         The unregistered shareware version of Audio Compact Disc Controller
  138.         may be distributed freely by distributors of shareware / user sup-
  139.         ported software, file distribution nets, bulletin boards etc., via
  140.         modems, disks, CD-ROM disks etc., but only if all files are included
  141.         completely and unmodified, preferably in one single archive file.
  142.  
  143.         The Audio Compact Disc Controller program MUST NOT be bundled with
  144.         any piece of hardware without a written permission from the author.
  145.  
  146.         You are encouraged to pass a copy of the unregistered version of
  147.         Audio Compact Disc Controller along to your friends and associates
  148.         for evaluation, but please remember to include all files.
  149.         Audio Compact Disc Controller v1.20                           Page 3
  150.  
  151.  
  152.  
  153.  
  154.                                    SHAREWARE
  155.  
  156.  
  157.         The essence of "try-before-you-buy" or "user-supported" software is
  158.         to provide personal computer users with quality software without
  159.         high prices, and yet to provide incentive for software developers to
  160.         continue to develop new products. If you find the Audio Compact Disc
  161.         Controller useful, and find that you are using the program and con-
  162.         tinue to use it after a trial period of 30 days, you must make a
  163.         registration payment to Anders Roar Nielsen, the author of the pro-
  164.         gram. You will then receive your copy of the full featured program,
  165.         licensed for use on any one computer at any one time.
  166.         You can read more about how to register later in this manual.
  167.  
  168.  
  169.  
  170.  
  171.                                  INTRODUCTION
  172.  
  173.  
  174.         For quite a long time I was looking around for a good audio CD play-
  175.         er program for dos. The program that came with my CD-ROM was very
  176.         disappointing, and I soon wanted something better.
  177.  
  178.         Well, I found a lot of CD players for Microsoft Windows, many of
  179.         them good, some of them not so good, but I couldn't find a good dos
  180.         program.
  181.         The reason for this could be that it is easier to write a Windows
  182.         CD player program, since you don't have to produce code for the CD-
  183.         ROM yourself. Nice, but not really what I wanted. I wanted a dos
  184.         program.
  185.  
  186.         Finally, I decided to write the program myself. I wanted the program
  187.         to have almost the same features found on many hi-fi CD players, and
  188.         pretty soon I got the idea about having the program to play my favo-
  189.         rite tracks while running other programs.
  190.         This of course meant that I would have to make it as a resident pro-
  191.         gram, capable of monitoring and controlling the CD-ROM while running
  192.         another program.
  193.         I have seen several other programs claiming "background music".
  194.         In their term, this normally means "leave the CD playing when you
  195.         exit the program". Well, ACDC not only gives you background music,
  196.         but also background control, letting you choose what to play, and
  197.         not just leaving the CD to play from the start to the end.
  198.  
  199.         I hope you will enjoy it as much as I do.
  200.         Audio Compact Disc Controller v1.20                           Page 4
  201.  
  202.  
  203.  
  204.  
  205.                                     WARNING
  206.  
  207.  
  208.         As mentioned earlier, ACDC is a resident (TSR) program.
  209.         This means, that ACDC will be located in your computers memory,
  210.         waiting for you to press a dedicated hotkey by which time the pro-
  211.         gram will try to pop-up on top of whatever program you are using.
  212.  
  213.         Even though every effort has been made to make this a safe program
  214.         to use, you might find that you cannot activate the program on top
  215.         of certain programs. This might most likely be the case if the other
  216.         program changes some of the interrupt vectors, thereby not allowing
  217.         ACDC to monitor the important interrupt calls.
  218.  
  219.         *** This can cause a system crash if you are unlucky! ***
  220.  
  221.         An example could be dos' Edit. This program is written is such a
  222.         clumsy way that your system is almost guaranteed to crash if you try
  223.         to activate ACDC on top of Edit. I have however found no problems
  224.         when popping up on top of well written major applications like Word-
  225.         Perfect 5.1, Borland Pascal, AutoCad R12's textmode screen, and many
  226.         many more, including Microsoft Windows when used as described later.
  227.         But you are advised never to have a large amount of unsaved work
  228.         when you try to activate ACDC.
  229.  
  230.  
  231.  
  232.  
  233.                         HARD- AND SOFTWARE REQUIREMENTS
  234.  
  235.  
  236.         Hardware:
  237.  
  238.         A IBM personal computer, or true compatible.
  239.  
  240.         The BIOS must support the keyboard intercept interrupt, int 15h,
  241.         ah=4Fh. This is used when checking for the programs hotkey.
  242.  
  243.         The pc must be equipped with a color VGA and at least one CD-ROM
  244.         capable of playing audio CD's.
  245.  
  246.         A mouse is a good idea, although not required.
  247.  
  248.  
  249.         Software:
  250.  
  251.         Dos 3.10 or later.
  252.  
  253.         Whatever device driver that your CD-ROM drive needs to operate.
  254.  
  255.         Microsoft CD-ROM extension, MSCDEX.EXE version 2.21 or later.
  256.         Audio Compact Disc Controller v1.20                           Page 5
  257.  
  258.  
  259.  
  260.  
  261.                                      FILES
  262.  
  263.  
  264.         The complete package consists of 8 files:
  265.  
  266.  
  267.         Filename:    Size:   Date:   Time:  Description:
  268.  
  269.          FILE_ID.DIZ   615  08-01-94  1.20  A short description file.
  270.  
  271.             ACDC.COM 23859  08-01-94  1.20  The main program.
  272.  
  273.         POP_ACDC.EXE  4288  08-01-94  1.20  A pop-up utility meant to be
  274.                                             used with Microsoft Windows 3.1.
  275.  
  276.             ACDC.PIF   545  08-01-94  1.20  Program-Information-File for
  277.                                             Microsoft Windows 3.1.
  278.  
  279.             ACDC.ICO   766  08-01-94  1.20  Icon for Microsoft Windows.
  280.  
  281.             ACDC.DOC 41508  08-01-94  1.20  This document.
  282.  
  283.            ORDER.FRM  2867  08-01-94  1.20  Order form to print out if you
  284.                                             want to register the program.
  285.  
  286.          UPGRADE.FRM  2634  08-01-94  1.20  Upgrade form to print out if you
  287.                                             want to upgrade your previously
  288.                                             registered copy of the program.
  289.  
  290.  
  291.  
  292.                                  INSTALLATION
  293.  
  294.  
  295.         To install the program on your harddisk, all you have to do is copy
  296.         the files to the directory where you want the program located.
  297.  
  298.  
  299.  
  300.                                    START UP
  301.  
  302.  
  303.         You start up by executing ACDC.COM from dos' command line.
  304.         The program will carry out a few checks, and if everything is ok,
  305.         the program will terminate with a "Resident part installed" message.
  306.         There are several command line options that you can use. To get a
  307.         quick overview, enter ACDC /H or ACDC /?. This will show the command
  308.         line options instead of installing the program. The options are de-
  309.         scribed in details in the "COMMAND LINE OPTIONS" section later.
  310.         If the program doesn't install or work properly, you are advised to
  311.         read the "TROUBLESHOOTING" section later in this manual.
  312.         Audio Compact Disc Controller v1.20                           Page 6
  313.  
  314.  
  315.  
  316.  
  317.                                USING THE PROGRAM
  318.  
  319.  
  320.         When you have installed the program, you must press its special hot-
  321.         key to activate the program. The default hotkey is CTRL+ALT+A; Press
  322.         CTRL and ALT and hold them down while you press A.
  323.         When you press the hotkey, the program checks different things to
  324.         determine if it is safe to activate. These checks include dos, key-
  325.         board and harddisk activity, and the current videomode. The program
  326.         can only be activated if your pc is in video mode 3, that is stan-
  327.         dard 80 x 25 character color mode.
  328.         If everything looks ok, the program pops up, ready for you to use.
  329.         If unable to pop up, the program will continue to try for 3 seconds
  330.         after you pressed the hotkey. If the program is unable to pop up
  331.         within those 3 seconds, the pop up request is cancelled, and you
  332.         must press the hotkey to try again.
  333.  
  334.         The main part of the ACDC display looks like a typical hi-fi CD
  335.         player, with buttons to press, and a time display to the right. The
  336.         program also features a status display, showing the current state of
  337.         your CD-ROM. The location scrollbar shows the position within the
  338.         current track, and the program bar shows the track numbers on the
  339.         compact disc.
  340.  
  341.         All the button have their function written in green capital letters.
  342.         The buttons can be pressed by using a mouse or by pressing a key on
  343.         your keyboard.
  344.  
  345.         If you are using a mouse, you simply click a mouse button (left or
  346.         right) when then mouse cursor is on the CD-button you want to press.
  347.  
  348.         If you are using your keyboard, the key to press is either shown in
  349.         dark red below the CD-button, like F1 below the play/pause button,
  350.         or it is shown in yellow as one of the letters in the function text,
  351.         like R in RAND.
  352.  
  353.         Note that the program doesn't check or change the palette or font
  354.         when activated. If your foreground program has changed the palette
  355.         or font, the CD player might look funny. Furthermore, the program
  356.         doesn't check or change if the VGA card has been set up to show high
  357.         intensity background colors instead of blinking characters.
  358.  
  359.  
  360.  
  361.  
  362.                                    FUNCTIONS
  363.  
  364.  
  365.         POWER : ( Keyboard: Escape )
  366.             Quit the program and return you to whatever you were doing when
  367.             you activated the program.
  368.         Audio Compact Disc Controller v1.20                           Page 7
  369.  
  370.  
  371.  
  372.  
  373.         PLAY/PAUSE/RESUME : ( Keyboard: F1 )
  374.             Starts playing. The function of the play button will toggle be-
  375.             tween play, pause and resume, depending on the status of your
  376.             CD-ROM.
  377.  
  378.  
  379.  
  380.         STOP : ( Keyboard : F2 )
  381.             Stop playing. Go back to the beginning of the first track.
  382.  
  383.  
  384.  
  385.         SKIP reverse : ( Keyboard: F3, "-" or down arrow )
  386.             Go to beginning of current track, or, if within first second of
  387.             the current track, go back to previous track.
  388.  
  389.  
  390.  
  391.         SKIP forward : ( Keyboard: F4, "+" or up arrow )
  392.             Go to beginning of next track.
  393.  
  394.  
  395.  
  396.         SCAN reverse : ( Keyboard: Shift-F3 or left arrow )
  397.             Accelerating reverse scan. If you hold down the SCAN button, the
  398.             scan will accelerate, this however works best when activated
  399.             with mouse since the keyboard repeat will interrupt the scan.
  400.  
  401.  
  402.  
  403.         SCAN forward : ( Keyboard: Shift-F4 or right arrow )
  404.             Accelerating forward scan. Works like SCAN reverse.
  405.             Reverse and forward scan can also be activated by clicking a
  406.             mouse button when the mouse cursor is at one of the two green
  407.             arrows to the left and right of the location scrollbar.
  408.  
  409.  
  410.  
  411.         Left  volume down / up. ( Keyboard : F5 / F6 )
  412.         Right volume down / up. ( Keyboard : F7 / F8 )
  413.         Both volumes down / up. ( Keyboard : F9 / F10 )
  414.             Note: Not all CD-ROM drives support volume control, and many
  415.             drives support it with fewer steps than ACDC use. The program
  416.             passes one byte to the device driver for left and right volume,
  417.             but how well the volume control is done, depends on the CD-ROM
  418.             and the device driver. The volume is changed in steps of 16, but
  419.             can be stepping 1 if the program is installed with /V switch.
  420.         Audio Compact Disc Controller v1.20                           Page 8
  421.  
  422.  
  423.  
  424.  
  425.         Numeric keypad : ( Keyboard : 0 - 9 )
  426.             You can enter a track number using the numeric keypad to the
  427.             left. When you do so, the number will flash for approximately
  428.             4 seconds in the time display. If you within that period press
  429.             play or skip, you will jump directly to the track you entered.
  430.  
  431.  
  432.  
  433.         SCAN : ( Keyboard : S )
  434.             Play a intro scan of the tracks on the disc. Normally this means
  435.             play 10 seconds of each track when you press Play. However, if
  436.             you have entered a number and the number is flashing in the time
  437.             display as described above, the intro scan will play that number
  438.             of seconds of each track. In this way it is possible to play a
  439.             intro scan of 1 - 99 seconds of each track.
  440.  
  441.  
  442.  
  443.         A-B : ( Keyboard : B )
  444.             Repeat playing between two locations. First time you press A-B,
  445.             the program will memorize the current location, and the A-B but-
  446.             ton will start to flash. Second time you press A-B, the program
  447.             will memorize the current location once again, and from there on
  448.             the playing will be repeated between the two locations until you
  449.             press A-B again.
  450.  
  451.  
  452.  
  453.         ONE : ( Keyboard : N )
  454.             Repeat current track when playing.
  455.  
  456.  
  457.  
  458.         ALL : ( Keyboard : A )
  459.             Repeat all tracks when playing.
  460.  
  461.  
  462.  
  463.         RAND : ( Keyboard : R )
  464.             Play tracks in random order. When the program is playing random
  465.             track, you can force a new random selection be pressing Return
  466.             (Enter). This function cannot be activated with the mouse.
  467.  
  468.  
  469.  
  470.         Note on Scan, A-B, One, All and Rand:
  471.             The five functions act as "radio"-buttons: Only one at a time
  472.             can be activated. You can freely switch from one repeat-state
  473.             to another without interrupting the music. Your selection will
  474.             remain in effect after you quit the program, thus enabling for
  475.             example continuous background random playing.
  476.         Audio Compact Disc Controller v1.20                           Page 9
  477.  
  478.  
  479.  
  480.  
  481.         OPEN / CLOS : ( Keyboard : O )
  482.             Open (eject) or close the CD-ROM drives door. Toggles between
  483.             open and close, depending on the actual state of your CD's door.
  484.             Note that many CD-ROM drives don't support eject, and even more
  485.             CD-ROM drives don't support the close command. Note also, that
  486.             your CD-ROM probably won't open if it is playing. You must then
  487.             press STOP (F2) first, before you can open the door.
  488.  
  489.  
  490.  
  491.         LOCK / UNLK : ( Keyboard : L )
  492.             Lock or unlock the CD-ROM. Toggles between lock and unlock,
  493.             depending on the actual state of your CD-ROM.
  494.  
  495.             Note: Many CD-ROM drives don't support lock / unlock commands.
  496.  
  497.  
  498.  
  499.         MUTE : ( Keyboard : M )
  500.             Instantly muting the output. A second press, or a press on one
  501.             of the volume buttons, will restore the volume settings.
  502.  
  503.             Note: Depends of the capability to handle volume control as
  504.             described earlier.
  505.  
  506.  
  507.  
  508.         PROG : ( Keyboard : P )
  509.             Programming. This feature is only available in the registered
  510.             version of the program. You can program a sequence of up to 99
  511.             tracks, and still use all the other goodies as skip, scan, re-
  512.             peats, random play etc, and ACDC will of course play your track
  513.             selection in the background of other programs.
  514.             You can read more about how to register later in this manual.
  515.  
  516.  
  517.  
  518.  
  519.         TIME : ( Keyboard : T )
  520.             Changes the time display. The are 6 different time display for-
  521.             mats. Each time you press TIME you will go to the next in this
  522.             sequence:
  523.             0: Current track + elapsed track time.
  524.             1: Current track + remaining track time.
  525.             2: Current track + elapsed total disc (or program) time.
  526.             3: Current track + remaining total disc (or program) time.
  527.             4: Current track + actual time in HH:MM.
  528.             5: Actual time in HH:MM:SS (taken from your pc's system clock).
  529.         Audio Compact Disc Controller v1.20                          Page 10
  530.  
  531.  
  532.  
  533.  
  534.         Location scroll bar and Program listing:
  535.  
  536.             If you are using a mouse, you can click directly on the location
  537.             bar to go to a location within the current track, or you can
  538.             click and hold down the mouse button and drag the location poin-
  539.             ter. You can also jump to a track directly if you click when the
  540.             mouse cursor is on a track number in the program listing.
  541.  
  542.  
  543.  
  544.  
  545.         At the bottom of the screen you will find three more buttons:
  546.  
  547.  
  548.  
  549.         RESET : ( Keyboard : Z )
  550.             Send a reset command to the CD-ROM drive.
  551.  
  552.  
  553.  
  554.         CD-ROM : ( Keyboard : C )
  555.             If you have more then one CD-ROM drive, pressing the CD-ROM
  556.             button will take you to the next CD-ROM. The drive letter, for
  557.             example "D:" will be shown to the right of the CD-ROM button
  558.             together with the total playing time of the disc inserted in the
  559.             CD-ROM drive. The CD-ROM change works by sending commands to the
  560.             new device driver, not by subunits.
  561.  
  562.  
  563.  
  564.         DISPLAY : ( Keyboard : D )
  565.             When the program is not popped up, you can have the time display
  566.             shown in one corner of your screen while running another pro-
  567.             gram. By pressing the Display button you select between No Dis-
  568.             play, Top Left, Top Right, Bottom Left and Bottom Right. When
  569.             you exit ACDC the selected will take effect, and you can monitor
  570.             the playing while using other programs. Note however, that the
  571.             time display will only be shown when you are working in standard
  572.             video mode 3 ( 80 x 25 color text mode).
  573.         Audio Compact Disc Controller v1.20                          Page 11
  574.  
  575.  
  576.  
  577.  
  578.                    USING THE PROGRAM WITH MICROSOFT WINDOWS
  579.  
  580.  
  581.         The program can easily be used together with Microsoft Windows, even
  582.         though the program is a dos TSR program.
  583.         The best way to make use of ACDC is to have it installed resident in
  584.         memory before you start up Windows.
  585.         First time you want to use the program together with Windows, you
  586.         should spend a minute setting it all up.
  587.  
  588.         Here are the few steps you should take:
  589.  
  590.         In the following, I assume that you have ACDC installed in a direc-
  591.         tory C:\ACDC on your harddisk, and I assume that you want the ACDC
  592.         icon to appear in the Accessories group in Windows.
  593.         If this is not the case, you should of course use your own directory
  594.         and group name.
  595.  
  596.         First, before you enter Windows, install ACDC by executing ACDC.COM,
  597.         then start up Windows.
  598.  
  599.         When you are in Windows, open up the Accessories group.
  600.  
  601.         From the Program Managers file menu, you then choose the menu item
  602.         New... and click "Ok" to confirm you want to add a program item.
  603.  
  604.         As Description you then insert "Acdc" and as Command line you insert
  605.         C:\ACDC\ACDC.PIF
  606.  
  607.         You then click "Change Icon" and click "Ok" to the first message
  608.         about no icons in the file.
  609.  
  610.         In the following File Name box you then enter C:\ACDC\ACDC.ICO
  611.  
  612.         Finally, you click ok's to take you back to where you started out
  613.         from, and the ACDC icon should now appear in the Accessories group.
  614.  
  615.         What now happens when you double-click the ACDC icon is, that the
  616.         pif-file ACDC.PIF executes the POP_ACDC.EXE program. This is a small
  617.         dos application that sends a pop-up request to the resident part of
  618.         ACDC.COM. If you did install ACDC before you started Windows, the
  619.         program will pop-up, ready for you to use.
  620.         When you exit ACDC you will automatically be returned to Windows.
  621.  
  622.         If you have chosen for example random play, this will continue to
  623.         work behind Windows.
  624.         Audio Compact Disc Controller v1.20                          Page 12
  625.  
  626.  
  627.  
  628.  
  629.                              COMMAND LINE OPTIONS
  630.  
  631.  
  632.         The following command line options can be used when executing ACDC:
  633.         ( You can use "-" instead of "/", for example "ACDC -L" )
  634.  
  635.         /L     Install in low memory. Normally, the program will install the
  636.                resident part in upper memory if upper memory is available.
  637.                Specifying /L will force the program to install the resident
  638.                part in low (conventional) memory.
  639.  
  640.  
  641.         /K:x   Use x (x = A-Z) as hotkey. The program will be activated when
  642.                you press Ctrl+Alt+x. Default is Ctrl+Alt+A.
  643.  
  644.  
  645.         /C:x   Start up using CD-ROM drive x.  x is a CD-ROM drive letter,
  646.                for example /C:E if you want the program to start up using
  647.                drive E:  Default is first CD-ROM drive found.
  648.  
  649.  
  650.         /D:x   Start up displaying the time display at position x.  x can be
  651.                0 for no display (default), 1 for top left corner, 2 for top
  652.                right, 3 for bottom left and 4 for bottom right corner.
  653.                The time will only be displayed when you are in 80 x 25 cha-
  654.                racter color text mode (Video mode 3).
  655.  
  656.  
  657.         /T:x   Start up using time format x.  x can be 0 for track + elapsed
  658.                track time (default), 2 for track + remaining track time, 3
  659.                for track and elapsed disc time, 4 for track and remaining
  660.                disc time, 5 for track + clock (HH:MM), 6 for complete clock
  661.                (HH:MM:SS).
  662.  
  663.  
  664.         /B     Force RedBook addressing mode. When sending a play or seek
  665.                command it is normally possible to use two different kinds of
  666.                addressing modes, RedBook or HSG. As default ACDC will use
  667.                HSG mode, but you can force RedBook mode with /B.
  668.  
  669.  
  670.  
  671.         /V     Use volume control step 1. As default the volume controls
  672.                will change the left and right volumes in steps of 16, giving
  673.                17 possible settings: 0,16,32,48,64,80,96,112,128,144,160,
  674.                176,192,208,224,240 and 255. If you specify /V then volumes
  675.                will be change in steps of 1 instead, from 0 to 255.
  676.         Audio Compact Disc Controller v1.20                          Page 13
  677.  
  678.  
  679.  
  680.  
  681.         /N     No checks before installing. Normally the program will check
  682.                dos and mscdex version, and search for CD-ROM drives. If you
  683.                specify /N the program will bypass these checks. In this way
  684.                you can install the program on a pc without a CD-ROM if you
  685.                for some reason should want to do so.
  686.  
  687.  
  688.         /P     The program will try to pop-up as soon as it is installed.
  689.  
  690.  
  691.         /? /H  Display a short summary of the command line options. The re-
  692.                sident part of the program will not be installed.
  693.  
  694.  
  695.         /R /U  Specifying /R or /U will remove (uninstall) the program.
  696.  
  697.  
  698.  
  699.  
  700.                                 TROUBLESHOOTING
  701.  
  702.  
  703.         If you cannot get the program to run satisfying, the following are
  704.         some things you could try to solve the problem.
  705.  
  706.         First of course make sure that you have installed whatever device
  707.         driver your CD-ROM use, and make sure you have mscdex version 2.21
  708.         or later installed.
  709.  
  710.         Also you should try to determine that whatever problem you have, has
  711.         nothing to do with other programs you might have installed.
  712.         Try and setup your pc as "clean" as possible, without other device
  713.         drivers and TSRs installed, and see if you still have the same pro-
  714.         blem when executing ACDC. You might find that you have to install
  715.         your TSRs in a specific order to get them all to work correctly.
  716.  
  717.         Finally, try and play around with the possible command line options.
  718.         You may find, that you must use /N or /B to get the program to work
  719.         correctly.
  720.  
  721.         You could also try and contact your CD-ROM dealer, to see if there
  722.         is an updated device driver available for your CD-ROM.
  723.  
  724.         If you are still unable to get the program to work satisfying, I am
  725.         afraid you are out of luck, but then I would appreciate a message
  726.         from you describing exactly what problem you have. Please include as
  727.         much information as possible; pc-type, CD-ROM type/model, dos and
  728.         mscdex-version, other programs installed etc.
  729.         Audio Compact Disc Controller v1.20                          Page 14
  730.  
  731.  
  732.  
  733.  
  734.                                  REGISTRATION
  735.  
  736.  
  737.         The Audio Compact Disc Controller is a Shareware program. This
  738.         means, that if you find that you can use the program, and find that
  739.         you continue to use the program after a 30 days trial period, you
  740.         must pay a registration fee to Anders Roar Nielsen, the author of
  741.         Audio Compact Disc Controller.
  742.         When you register the program you will receive a 3,5" 720 kb disk
  743.         with you personal copy of the full-featured registered program.
  744.  
  745.         The registered version includes complete programming facility, and
  746.         doesn't show the registration reminder when you exit the program.
  747.         You can program a sequence of up to 99 tracks, and let ACDC play
  748.         your track selection in the background of most other applications.
  749.         When you have programmed ACDC, you still have full access to all the
  750.         other functions like skip, scan, random play etc.
  751.  
  752.         A registration also entitles you to update to future versions at
  753.         large discounts.
  754.  
  755.         A normal registration fee will license one copy for use on any one
  756.         computer at any one time. Discounts are available for quantity and
  757.         corporate purchases and site licenses:
  758.  
  759.                              Quantity            Site
  760.                              Purchases:          License:
  761.  
  762.           1 - 10 copies:     No  discount        No  discount
  763.          11 - 20 copies:     10% discount        15% discount
  764.          21 - 30 copies:     15% discount        20% discount
  765.          31 - 50 copies:     20% discount        25% discount
  766.          51 -100 copies:     25% discount        30% discount
  767.         100 copies plus:     30% discount        35% discount
  768.  
  769.         Multiple copy purchases are simply bulk purchases and include that
  770.         many copies of Audio Compact Disc Controller on disks.
  771.         When site licensing, the site performs the diskette duplication from
  772.         a single master disk.
  773.         Note: Discounts apply only to separate orders, they are not cumula-
  774.               tive. Discounts apply only to the normal registration fee.
  775.               There are no discounts for foreign cheque fee and p&p.
  776.  
  777.         To register, you should print out the file ORDER.FRM, fill it out,
  778.         and send the form together with your payment to the address given on
  779.         the order form.
  780.         Please follow the guidelines on the order form carefully.
  781.         Audio Compact Disc Controller v1.20                          Page 15
  782.  
  783.  
  784.  
  785.  
  786.         The registration fees depend on where you live:
  787.  
  788.  
  789.         If you live outside Denmark:
  790.  
  791.             You must include the registration fee on a cheque. The cheque
  792.             MUST be a cheque issued by your bank. I DO NOT accept a personal
  793.             cheque drawn on your own account. Only a bank cheque.
  794.  
  795.             You are free to choose between paying in German Marks (DEM) or
  796.             in Danish Kroner (DKK).
  797.  
  798.             If you pay in German Marks (DEM), fees are:
  799.  
  800.                 Registration fee..: DEM  38 (discounts available, see above)
  801.                 Foreign cheque fee: DEM  15 (per cheque, no discounts)
  802.                 Postage & packing.: DEM  10 (per disk, no discounts)
  803.                 Total fee for one copy is 38+15+10 = DEM 63.
  804.  
  805.  
  806.             If you pay in Danish Kroner (DKK), fees are:
  807.  
  808.                 Registration fee..: DKK 150 (discounts available, see above)
  809.                 Foreign cheque fee: DKK  60 (per cheque, no discounts)
  810.                 Postage & packing.: DKK  39 (per disk, no discounts)
  811.                 Total fee for one copy is 150+60+39 = DKK 249.
  812.  
  813.             Due to the danish bank laws, I an unable to accept credit cards
  814.             or other kind of payments.
  815.             Only a cheque issued by/drawn directly on your bank is accepted.
  816.  
  817.  
  818.         If you live in Denmark:
  819.  
  820.            You can pay with a normal cheque, as long as it is drawn on a
  821.            danish bank.
  822.  
  823.                 Registration fee..: DKK 150 (discounts available, see above)
  824.                 Postage & packing.: DKK  29 (per disk, no discounts)
  825.                 Total fee for one copy is 150+29 = DKK 179 when you live in
  826.                 Denmark.
  827.         Audio Compact Disc Controller v1.20                          Page 16
  828.  
  829.  
  830.  
  831.  
  832.                                    UPGRADING
  833.  
  834.  
  835.         If you are among the many happy, and registered, users of ACDC, you
  836.         can upgrade your registered version very easily and cheap.
  837.         When you upgrade, you will receive a new disk with your registered
  838.         copy of the latest version of the Audio Compact Disc Controller.
  839.  
  840.         To upgrade, first print UPGRADE.FRM, fill it out, and send it
  841.         together with your upgrade payment. Discount rates and rules are the
  842.         same for upgrading as for registering, please refer to the previous
  843.         section. As with the registration fee, the update fee depends on
  844.         where you live:
  845.  
  846.         If you live outside Denmark:
  847.  
  848.             You must include the upgrade fee on a cheque. The cheque MUST be
  849.             a cheque issued by your bank. I DO NOT accept a personal cheque
  850.             drawn on your own account. Only a bank cheque.
  851.  
  852.             You are free to choose between paying in German Marks (DEM) or
  853.             in Danish Kroner (DKK).
  854.  
  855.             If you pay in German Marks (DEM), fees are:
  856.  
  857.                 Upgrade fee.......: DEM   5 (discounts available, see above)
  858.                 Foreign cheque fee: DEM  15 (per cheque, no discounts)
  859.                 Postage & packing.: DEM  10 (per disk, no discounts)
  860.                 Total fee for one upgrade is 5+15+10 = DEM 30.
  861.  
  862.  
  863.             If you pay in Danish Kroner (DKK), fees are:
  864.  
  865.                 Upgrade fee.......: DKK  20 (discounts available, see above)
  866.                 Foreign cheque fee: DKK  60 (per cheque, no discounts)
  867.                 Postage & packing.: DKK  39 (per disk, no discounts)
  868.                 Total fee for one upgrade is 20+60+39 = DKK 119.
  869.  
  870.             I am unable to accept credit cards or other kind of payments.
  871.             Only a cheque issued by/drawn directly on your bank is accepted.
  872.  
  873.  
  874.         If you live in Denmark:
  875.  
  876.            You can pay with a normal cheque, as long as it is drawn on a
  877.            danish bank.
  878.  
  879.                 Upgrade fee.......: DKK  20 (discounts available, see above)
  880.                 Postage & packing.: DKK  29 (per disk, no discounts)
  881.                 Total fee for one upgrade is 20+29 = DKK 49 when you live
  882.                 in Denmark.
  883.         Audio Compact Disc Controller v1.20                          Page 17
  884.  
  885.  
  886.  
  887.  
  888.                    GETTING THE LATEST VERSION OF THE PROGRAM
  889.  
  890.  
  891.         The latest shareware version of the Audio Compact Disc Controller is
  892.         always available for download or file request (magic file request
  893.         name ACDC) from FidoNet 2:234/87 and 2:234/166.
  894.  
  895.         2:234/87 is NightCall BBS line 1, Svendborg, Denmark.
  896.         Phone (+45)-62202074, 0700-0230, GMT.
  897.         USRobotics HST / V32b / V42b, 300-14400 bps.
  898.  
  899.         2:234/166 is NightCall BBS line 2.
  900.         Phone (+45)-62201450, 0700-0200, GMT.
  901.         ZyXEL V32b / V42b, 300-19200 bps.
  902.  
  903.  
  904.  
  905.  
  906.                              CONTACTING THE AUTHOR
  907.  
  908.  
  909.         Your comments, suggestions, etc. are always welcome.
  910.         If possible, please use FidoNet netmail to 2:234/87.8, thank you.
  911.         You can crash netmail to me at my sysop's BBS, see above.
  912.  
  913.  
  914.  
  915.  
  916.                                    CREDITS
  917.  
  918.  
  919.         Credits to:
  920.  
  921.         Ralf Brown. The Audio Compact Disc Controller uses his Alternate
  922.         Multiplex Interrupt Specification, (AMIS).
  923.         And I apologize for writing "Braun" in the documentation to version
  924.         1.00 and 1.10. Don't really know where I got that silly idea from.
  925.         "Brown" it is, sorry Ralf.
  926.  
  927.         John Mellencamp. For the best CD's for testing and listening.
  928.         Audio Compact Disc Controller v1.20                          Page 18
  929.  
  930.  
  931.  
  932.                                  FUTURE PLANS
  933.  
  934.  
  935.         I've had several requests to include a CD-database function in ACDC,
  936.         so the program can display artist, songtitles etc. when playing.
  937.         Well, this is not so hard to implement. The reason why I haven't
  938.         done it, is that I chose to keep the program relative small. As it
  939.         is now, the programs resident part takes up roughly 20 kb of memory,
  940.         and I don't think that a too big tsr program is attractive, since
  941.         you also must have device drivers, mscdex, etc. installed.
  942.         But if I can keep memory usage down, I might implement it, or make a
  943.         special version featuring the database.
  944.  
  945.         I have also noticed an increasing interest among programmers for
  946.         sourcecode to play audio CD's. I am therefore considering releasing
  947.         code similar to the routines used in ACDC. Although ACDC is written
  948.         in 100% assembler to keep the program size down, the code might come
  949.         as a unit for Borland Pascal, or as an OBJ file. I wont promise an
  950.         exact release date, but properly sometime during february 1994, if
  951.         I am not to busy with my other programming projects and ideas.
  952.  
  953.         Anyway, keep your suggestions coming, and stay tuned!
  954.  
  955.  
  956.  
  957.                                REVISION HISTORY
  958.  
  959.  
  960.         1.20  Released 8. january 1994:
  961.  
  962.             Default addressing mode changed, eliminating /S option.
  963.             /P direct pop-up option added.
  964.             Volume control changed to step 16, and /V option added.
  965.             "-" can now be used as command line switch instead of "/".
  966.             Option for retriggering random track selection added.
  967.             Faster pop-up on many systems.
  968.             The fix from version 1.10 has been improved.
  969.             Screen layout and color usage changed a bit.
  970.             Several other small internal fixes.
  971.  
  972.         1.10  Released 2. november 1993:
  973.  
  974.             Contains a fix to improve performance on a certain Sony CD-ROM
  975.             that start music playing at the end of one track when actually
  976.             told to start playing from beginning of the following track.
  977.             Furthermore, the program now is less cpu demanding when not
  978.             popped up and music isn't playing.
  979.  
  980.  
  981.         1.00  Released 15. october 1993:
  982.  
  983.             First official release.
  984.